home *** CD-ROM | disk | FTP | other *** search
/ Best of Shareware / Best of PC Windows Shareware 1.0 - Wayzata Technology (7111) (1993).iso / mac / DOS / MUSIC / MUGIF100 / MUSICGIF.DOC < prev    next >
Text File  |  1992-08-17  |  42KB  |  1,062 lines
  1.  
  2.        ====== MusicalGIF 1.00 ======================== Order Form ======
  3.  
  4.        Please send  cheque or money order  made payable to  'White River
  5.        Software', overseas order in money order, please.  (Note that the
  6.        current postage from US to Canada is $0.40.)
  7.  
  8.                White River Software
  9.                P.O.Box 938, Unit 105
  10.                St. Catharines, Ontario
  11.                L2R 6Z4  Canada
  12.  
  13.        -----------------------------------------------------------------
  14.  
  15.          Qty.     Item                                 US/CAD    Amount
  16.  
  17.  
  18.          ___  MusicalGIF Registration                 $20/$23  $________
  19.  
  20.          ___  GIFLITE Registration                    $20/$23  $________
  21.               (A GIF Compressor that reduces GIF size by 25%)
  22.  
  23.          ___  MusicalGIF & GIFLITE Registration       $35/$40  $________
  24.  
  25.                                      Add $1 each for 3.5 disk  $________
  26.  
  27.              Shipping $2 each ($4 each outside US and Canada)  $________
  28.  
  29.                                                      Subtotal  $________
  30.  
  31.              Ontario resident please add Prov. Sales Tax (8%)  $________
  32.  
  33.        Canadian resident please add Goods & Services Tax (7%)  $________
  34.  
  35.  
  36.                                          Total  US$________/CAD$________
  37.  
  38.  
  39.  
  40.        Name     ________________________________________________________
  41.  
  42.        Address  ________________________________________________________
  43.  
  44.                 ________________________________________________________
  45.  
  46.        Country  _____________________  Phone  (______) _________________
  47.  
  48.        Where did you first hear about MusicalGIF ?______________________
  49.  
  50.        Comments ________________________________________________________
  51.  
  52.        _________________________________________________________________
  53.  
  54.  
  55.        =================================================================
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.                                      MusicalGIF (tm) 1.00
  81.  
  82.  
  83.                                      ________________________________
  84.  
  85.  
  86.  
  87.                                      User Manual
  88.  
  89.  
  90.  
  91.  
  92.                                      (c) Copyright 1992
  93.  
  94.                                      White River Software
  95.                                      All Rights Reserved.
  96.  
  97.                                      17 August 1992
  98.  
  99.  
  100.  
  101.  
  102.  
  103.                                      P.O.Box 938 Unit 105
  104.                                      St. Catharines
  105.                                      Ontario, L2R 6Z4
  106.                                      Canada
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.                                 TABLE OF CONTENTS
  114.  
  115.  
  116.  
  117.         INTRODUCTION                                                  1
  118.  
  119.            What is MusicalGIF  . . . . . . . . . . . . . . . . . . .  1
  120.  
  121.  
  122.         REGISTRATION                                                  2
  123.  
  124.            Evaluation Version  . . . . . . . . . . . . . . . . . . .  2
  125.            License . . . . . . . . . . . . . . . . . . . . . . . . .  3
  126.            Disclaimer  . . . . . . . . . . . . . . . . . . . . . . .  3
  127.            Trademarks  . . . . . . . . . . . . . . . . . . . . . . .  3
  128.  
  129.  
  130.         USING MUSICAL GIF                                             4
  131.  
  132.            Installing MusicalGIF . . . . . . . . . . . . . . . . . .  4
  133.            Starting MusicalGIF . . . . . . . . . . . . . . . . . . .  5
  134.            Exiting MusicalGIF  . . . . . . . . . . . . . . . . . . .  5
  135.            Understanding the Desktop . . . . . . . . . . . . . . . .  6
  136.            Using the GIF & ROL Windows . . . . . . . . . . . . . . .  7
  137.  
  138.  
  139.         CUSTOMIZING MUSICAL GIF                                      10
  140.  
  141.            Screen  . . . . . . . . . . . . . . . . . . . . . . . . . 10
  142.            Picture . . . . . . . . . . . . . . . . . . . . . . . . . 11
  143.            Music . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  144.            Directories . . . . . . . . . . . . . . . . . . . . . . . 14
  145.            Colors  . . . . . . . . . . . . . . . . . . . . . . . . . 15
  146.  
  147.  
  148.         EXAMPLES                                                     16
  149.  
  150.            1. Using MusicalGIF as a GIF viewer . . . . . . . . . . . 16
  151.            2. Using MusicalGIF as a ROL player . . . . . . . . . . . 16
  152.            3. Playing ROL inside a ZIP or ARJ  . . . . . . . . . . . 16
  153.            4. Showing GIF and playing ROL at the same time . . . . . 16
  154.            5. Having ROL songs as background music . . . . . . . . . 17
  155.            6. Doing it all automatically . . . . . . . . . . . . . . 17
  156.  
  157.  
  158.  
  159.     MUSICAL GIF                                       INTRODUCTION    1
  160.  
  161.  
  162.     INTRODUCTION
  163.     ___________________________________________________________________
  164.  
  165.  
  166.         Since the introduction of the Adlib sound card and compatible,
  167.         playing music on the IBM PC is never the same again. The ROL
  168.         music file format has become one of the standards in composing
  169.         songs for the sound cards. But so far, only few programs are
  170.         able to play ROL music files and even fewer do it well.
  171.  
  172.         On the contrary, there are many GIF viewers in the market.
  173.         However, many of them are not quite easy to use.
  174.  
  175.         How about a program that do both of them really good?
  176.  
  177.  
  178.     WHAT IS MUSICAL GIF
  179.  
  180.         MusicalGIF is an easy to use ROL player and GIF viewer. Now you
  181.         can listen to ROL songs and view GIF pictures at the same time.
  182.         Best of all, you can put your ROL files into a ZIP file or ARJ
  183.         file to save a lot of disk space and MusicalGIF can still play
  184.         them.
  185.  
  186.         MusicalGIF provides a Windows-like environment with menus,
  187.         dialogs and mouse support. The standard environment guarantees
  188.         easy access to all the functions.
  189.  
  190.         If you have any questions, you can write to us, or leave e-mail
  191.         to "WINFRED HU" in the following BBSs' main board or in
  192.         CompuServe to [72070,3515]. We appreciate suggestions and
  193.         ideas.
  194.  
  195.            PC Connect:        Toronto, Canada (416)733-9052 2400
  196.            User To User #1:   Dallas, USA     (214)492-6565 USR-HST/ds
  197.            User To User #2:   Dallas, USA     (214)492-5695 HAYES V.32
  198.  
  199.  
  200.     MUSICAL GIF                                       REGISTRATION    2
  201.  
  202.  
  203.     REGISTRATION
  204.     ___________________________________________________________________
  205.  
  206.  
  207.         MusicalGIF is not free.  You must register after the 15-day
  208.         evaluation time period.
  209.  
  210.         MusicalGIF is a Shareware product. It is distributed through
  211.         public access channels so that perspective buyers can have the
  212.         opportunity to evaluate the product before making a decision to
  213.         buy. If you decide to use this software, then you are under
  214.         both legal and moral obligation to register it with the author.
  215.         But if you decide not to use it after evaluating the software,
  216.         you are under no obligation. It is fully protected by State,
  217.         Federal and International copyright laws.
  218.  
  219.         If you continue to use MusicalGIF after the 15-day evaluation
  220.         time period you must register it.
  221.  
  222.             Registration Fee  :           $ 20.0 US
  223.                                       or  $ 23.0 CAD
  224.  
  225.         To register your copy of MusicalGIF, fill in the order form and
  226.         mail along with your cheque or money order payable to "White
  227.         River Software" in US or CAD to the address indicated in the
  228.         form.
  229.  
  230.         When you register, you will receive the program diskette of the
  231.         current version with your registration number on it. The
  232.         registration number will remove the annoying ending screen of
  233.         the current and the FUTURE releases. Registration entitles you
  234.         continue using the current version and all future versions.
  235.  
  236.  
  237.     EVALUATION VERSION
  238.  
  239.         The evaluation version or the unregistered version distributed
  240.         through the Shareware channel is fully functional and has an
  241.         annoying ending screen reminding you it is a evaluation copy.
  242.  
  243.         The annoying ending screen is removed in the registered
  244.         version.
  245.  
  246.  
  247.     LICENSE
  248.  
  249.         You are free to copy and distribute MusicalGIF for NON-
  250.         COMMERCIAL use IF:
  251.               NO FEE IS CHARGED FOR USE, COPYING OR DISTRIBUTION,
  252.                       AND IT IS NOT MODIFIED IN ANY WAY.
  253.  
  254.         Computer user groups or clubs may make copies of MusicalGIF for
  255.         distribution to members for a fee that covers copying and other
  256.         administrative costs.  Bulletin Board Systems (BBS) that
  257.  
  258.     MUSICAL GIF                                       REGISTRATION    3
  259.  
  260.  
  261.         operate through subscription fees may post MusicalGIF for
  262.         download by its subscribers.
  263.  
  264.         Shareware vendor may distribute MusicalGIF, which includes the
  265.         program and the document, for a fee under US$8 which covers
  266.         copying and other administrative costs. Otherwise, the
  267.         distributors have to obtain a written permission from the
  268.         author.
  269.  
  270.  
  271.     DISCLAIMER
  272.  
  273.         This program is provided AS IS without any warranty, expressed
  274.         or implied, including but not limited to fitness for a
  275.         particular use.
  276.  
  277.  
  278.     TRADEMARKS
  279.  
  280.         MusicalGIF is a trademark of White River Software.
  281.  
  282.         Graphics Interchange Format and GIF are trademarks of
  283.         CompuServe Inc. and H&R Block Company.
  284.  
  285.         Adlib and Adlib Pro are trademarks of Adlib MultiMedia Inc.
  286.  
  287.         SoundBlaster and Sound Blaster Pro are trademarks of Creative
  288.         Lab Inc.
  289.  
  290.         Sound Master II is a trademarks of Covox Inc.
  291.  
  292.         Many specific products found in this manual are trademarks of
  293.         specific companies.
  294.  
  295.  
  296.     MUSICAL GIF                                  USING MUSICAL GIF    4
  297.  
  298.  
  299.     USING MUSICAL GIF
  300.     ___________________________________________________________________
  301.  
  302.  
  303.         MusicalGIF requires an IBM PC/AT/fully compatible computer, DOS
  304.         3.0 or greater, 512K bytes of memory and a VGA card and/or an
  305.         Adlib compatible sound card.
  306.  
  307.         Optional: MusicalGIF makes full use of EMS (EXPanded Memory),
  308.         XMS (EXTended Memory) and hard disk space as virtual memory.
  309.  
  310.         MusicalGIF supports the following VGA chip sets:
  311.  
  312.             AHead A,  AHead B,    ATI Wonder, Chips & Tech, Everex,
  313.             OAK Tech, Paradise,   Trident,    Trident 8900,
  314.             Tseng,    Tseng 4000, Video 7,    VESA compatibles
  315.  
  316.         and supports the following sound cards:
  317.  
  318.             Adlib, Adlib Gold, SoundBlaster, SoundBlaster Pro
  319.             Sound Master II and Adlib compatibles
  320.  
  321.  
  322.     INSTALLING MUSICAL GIF
  323.  
  324.         The MusicalGIF package includes
  325.  
  326.            MUSICGIF.EXE    MusicalGIF main program
  327.            MUSICGIF.DOC    this document
  328.            VENDOR.DOC      information for Shareware vendor
  329.            FILE_ID.DIZ     description of MusicalGIF
  330.            SOUND.COM       Adlib sound driver
  331.            STANDARD.BNK    Adlib instrument bank
  332.            BALLAD.ROL      sample ROL file
  333.  
  334.         To install MusicalGIF, simply run type MUSICGIF at the DOS
  335.         command line and press [Enter]. MusicalGIF will then check the
  336.         available VGA and SuperVGA mode. You should verify the screen
  337.         modes available under the Options/Screen dialog by pressing
  338.         [Alt O] [S], and you should turn off the screen modes that are
  339.         not actually supported by your VGA card.
  340.  
  341.         Next, you should examine the Adlib instrument bank file
  342.         STANDARD.BNK and the path of PKUNZIP.EXE and ARJ.EXE in the
  343.         Options/Directory dialog by pressing [Alt O] [D].
  344.  
  345.         *** IMPORTANT: You must specify the FULL path name of the
  346.             instrument bank file. Otherwise, the music will not play.
  347.  
  348.         When you press [Alt X] to exit the program, the options will be
  349.         saved automatically to the configuration file MUSICGIF.CFG.
  350.  
  351.  
  352.  
  353.     MUSICAL GIF                                  USING MUSICAL GIF    5
  354.  
  355.  
  356.     STARTING MUSICAL GIF
  357.  
  358.         Before running MusicalGIF, the Adlib sound driver SOUND.COM or
  359.         the SoundBlaster sound driver SB-SOUND.COM must be run first.
  360.         The sound driver is a TSR program, so you only need to run it
  361.         once. You can add the SOUND.COM to your AUTOEXEC.BAT so that it
  362.         will be run automatically whenever you turn on your computer.
  363.  
  364.         Starting MusicalGIF is easy. Most of the time, you just type
  365.         MUSICGIF in the command line to run it. However, you can
  366.         specify the directories of the GIF or ROL files to override the
  367.         startup directories. The command line structure is:
  368.  
  369.            MUSICGIF [GIF Files] [ROL Files]
  370.  
  371.         Parameters lists in [] are optional. If no parameter is
  372.         specified, MusicalGIF will show the GIF files in the GIF
  373.         Startup directory and ROL files in the ROL Startup directory
  374.         defined in the Options/Directory dialog. For example,
  375.  
  376.            MUSICGIF
  377.  
  378.         shows all the GIF files in the GIF Startup directory and all
  379.         the ROL files in the ROL Startup directory.
  380.  
  381.            MUSICGIF C:\GIF
  382.  
  383.         shows all the GIF files in the C:\GIF directory and all the ROL
  384.         files in the ROL Startup directory.
  385.  
  386.            MUSICGIF C:\ROL\B*.ROL
  387.  
  388.         shows all the GIF files in the GIF Startup directory and the
  389.         B*.ROL files in the C:\ROL directory.
  390.  
  391.            MUSICGIF C:\GIF\A*.GIF C:\ROL\*.ZIP
  392.  
  393.         shows the A*.GIF files in the C:\GIF directory and all the ROL
  394.         files inside in the C:\ROL\*.ZIP file.
  395.  
  396.  
  397.     EXITING MUSICAL GIF
  398.  
  399.         To exit MusicalGIF, press [Alt X]. The options will be saved
  400.         automatically to the configuration file MUSICGIF.CFG.
  401.  
  402.         You can shell to DOS temporarily to perform a DOS command by
  403.         choosing the File/Jump to DOS command. Then type EXIT at the
  404.         command line and press [Enter] to return to MusicalGIF.
  405.  
  406.  
  407.  
  408.     MUSICAL GIF                                  USING MUSICAL GIF    6
  409.  
  410.  
  411.     UNDERSTANDING THE DESKTOP
  412.  
  413.         The desktop consists of the menu bar at the top, the window
  414.         area in the middle, and the status line at the bottom.
  415.  
  416.     The Menu Bar
  417.  
  418.          ┌───────────────────────────────────────────────────────────┐
  419.          │ File  Options  Window                                     │
  420.          └───────────────────────────────────────────────────────────┘
  421.  
  422.         The menu bar allows you to access all the menu commands and
  423.         dialogs. To choose menu commands using the keyboard,
  424.  
  425.         1. Press [F10] to make the menu bar active.
  426.  
  427.         2. Use the arrow keys to select the menu you want to display.
  428.         Then press [Enter]. As a shortcut, you can just press the [Alt]
  429.         key and the highlighted letter of the menu title. For example,
  430.         [Alt F] displays the File menu.
  431.  
  432.         3. Use the arrow keys again to select a command from the menu
  433.         you have opened. Then press [Enter].
  434.  
  435.         To choose menu commands using the mouse, you can click the
  436.         desired menu title to display the menu and click the desired
  437.         command.
  438.  
  439.     The Windows
  440.  
  441.         The window area contains two windows: the GIF window and the
  442.         ROL window.
  443.  
  444.         The title bar, the topmost horizontal bar of a window, contains
  445.         the name of the window. Double-clicking the title bar zooms the
  446.         window. You can also drag the title bar to move the window
  447.         around.
  448.  
  449.         To select a window, you can click anywhere in the window, or
  450.         choose Window/Next to make the next window active. As a
  451.         shortcut, you can press [Shirt Esc] to make the next window
  452.         active.
  453.  
  454.         To zoom a window, you can click on the zoom box at the upper
  455.         right corner with the mouse, or choose Window/Zoom command.
  456.  
  457.         To move a window, you can drag the title bar with the mouse, or
  458.         choose the Window/Resize/Move command and use the arrow keys to
  459.         move the window.
  460.  
  461.         To resize a window, you can drag the lower-right corner with
  462.         the mouse, or choose the Window/Resize/Move command and press
  463.         [Shift] while you use the arrow keys to resize the window.
  464.  
  465.         To arrange the windows in cascade form, you can choose the
  466.         Window/Cascade command.
  467.  
  468.     MUSICAL GIF                                  USING MUSICAL GIF    7
  469.  
  470.  
  471.     The Status Line
  472.  
  473.          ┌──────────────────────────────────────────────────────────────────┐
  474.          │ Shift Esc Next window  Alt-C Change dir  Alt-X Exit       152880 │
  475.          └──────────────────────────────────────────────────────────────────┘
  476.  
  477.         The status line at the bottom reminds you of basic keystrokes
  478.         and shortcuts and lets you click the shortcuts to carry out the
  479.         action. The right most number shows the free memory in bytes.
  480.  
  481.  
  482.     USING THE GIF & ROL WINDOW
  483.  
  484.         The two windows are very similar, except that GIF window has a
  485.         button labeled [Show] and the ROL window has a button labeled
  486.         [Play].
  487.  
  488.      ╔══════════════════════════════ ROL Files ══════════════════════════[^]═╗
  489.      ║                                                                       ║
  490.      ║ » 9TO5        7K «│  BALLAD      2K  │  BOJANGLE    6K  >[   Play   ]<║
  491.      ║   AINTMISB    7K  │  BALLAD1     2K  │  BOOGIE      4K                ║
  492.      ║   ALLEYCAT    5K  │  BAROK       3K  │  BOSSA       3K   [  Toggle  ] ║
  493.      ║   AMERIC      2K  │  BAROQUE    10K  │  BRAHMS      3K                ║
  494.      ║   AMERICA    13K  │  BASERHAP    8K  │  BRAHMS1     5K   [Select All] ║
  495.      ║   ANITRA      8K  │  BAYOU       6K  │  BRASILIA   12K                ║
  496.      ║   ANNIESNG    6K  │  BEATLES1    6K  │  BUGLER     10K   [  Clear   ] ║
  497.      ║   ARIA        5K  │  BEATLES2    7K  │  BUNGLE     16K                ║
  498.      ║   ASHGROVE    3K  │  BEATLES4    5K  │  CALIOPE     5K                ║
  499.      ║   AUTLEAVS    5K  │  BEATLES5    5K  │  CANON       5K                ║
  500.      ║   AVEMARIA    7K  │  BEWALK      4K  │  CANONIND   12K                ║
  501.      ║   AXEL_F      6K  │  BLUES       2K  │  CANTINA    13K                ║
  502.      ║   BACH1      11K  │  BLUESY_W    6K  │  CARRIE      8K                ║
  503.      ║   BADMAN     15K  │  BLUGOOSE   15K  │  CHEERS      9K                ║
  504.      ║ <■▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒>              ║
  505.      ║                                                                       ║
  506.      ║ MUSIC.ARJ::9TO5.ROL        6301                        C:\MUSIC\*.ROL ║
  507.      ╚══════════════════════════════════════════════════════════════════════─┘
  508.  
  509.         The window contains a file list, buttons labeled [Show] (in the
  510.         GIF window) or [Play] (in the ROL window), [Toggle], [Select
  511.         All] and [Clear], and an information panel that describes the
  512.         file.
  513.  
  514.         You can press [Tab] or [Shift Tab] to change the focus among
  515.         the file list and the buttons.
  516.  
  517.     The File List Box
  518.  
  519.         The file list box displays all the GIF picture files you can
  520.         show or ROL music files you can play. You can use the array
  521.         keys to locate the files you want to select. Then you can press
  522.         [Spacebar] to toggle the selection of the file name, or press
  523.         [Enter] to Show or Play the selected files.
  524.  
  525.  
  526.     MUSICAL GIF                                  USING MUSICAL GIF    8
  527.  
  528.  
  529.     Showing GIF picture files
  530.  
  531.         To show GIF picture files, you can press [Enter] or click the
  532.         [Show] button in the GIF window. If no file is selected, the
  533.         current file in the file list box is shown.
  534.  
  535.         The selected files will be shown according to the options
  536.         specified in the Options/Picture dialog. The next section
  537.         describes the many picture options you can choose from.
  538.  
  539.     Playing ROL music files
  540.  
  541.         To play ROL music files, you can press [Enter] or choose the
  542.         [Play] button in the ROL window. If no file is selected, the
  543.         current file in the file list box is played.
  544.  
  545.         The selected files will be played according to the options
  546.         specified in the Options/Music dialog. The next section
  547.         describes the many music options you can choose from.
  548.  
  549.     Toggling a Selection
  550.  
  551.         You can press [Spacebar] to toggle the selection of the file or
  552.         click the [Toggle] button.
  553.  
  554.     Selecting All Files
  555.  
  556.         Clicking the [Select All] button or pressing [Alt A] selects
  557.         all the files in the file list box. If you select all the files
  558.         all the time, you can turn on the 'Select all at startup'
  559.         option under the Options/Picture dialog for the GIF files or
  560.         the Options/Music dialog for the ROL files.
  561.  
  562.     Clearing All Selection
  563.  
  564.         Clicking the [Clear] button or pressing [Esc] or [Alt L] clears
  565.         all the selected files in the file list box.
  566.  
  567.     Changing Directory
  568.  
  569.         The File/Change Dir command lets you specify a drive and a
  570.         directory for the current window. You can type in the path of
  571.         the new directory in the input box and press [Enter], or choose
  572.         the directory you want in the Directory tree then choose [OK]
  573.         or press [Esc].
  574.  
  575.         If you choose the [ChDir] button, the Directory Tree list box
  576.         changes to the selected directory and displays the
  577.         subdirectories of the currently highlighted directory. If you
  578.         change your mind about the directory you've picked and you want
  579.         to go back to the previous one, choose the [Revert] button.
  580.  
  581.  
  582.     MUSICAL GIF                                  USING MUSICAL GIF    9
  583.  
  584.  
  585.          ╔═[■]══════════ Change Directory ══════════════╗
  586.          ║                                              ║
  587.          ║  Directory name                              ║
  588.          ║   C:\GRAPH_________________ ▐v▌              ║
  589.          ║                                              ║
  590.          ║ »Directory tree                              ║
  591.          ║   Drives                      ^   [  OK  ]   ║
  592.          ║   └─┬C:\                      ▒              ║
  593.          ║  »  └──GRAPH                 «▒              ║
  594.          ║                               ▒  >[Chdir ]<  ║
  595.          ║                               ▒              ║
  596.          ║                               ▒              ║
  597.          ║                               ▒   [Revert]   ║
  598.          ║                               ▒              ║
  599.          ║                               ■              ║
  600.          ║                               v              ║
  601.          ║                                              ║
  602.          ╚══════════════════════════════════════════════╝
  603.  
  604.         If you choose the [OK] button, your changes will be made and
  605.         the dialog box put away. If the GIF window is active, the file
  606.         list displays all the GIF files in the selected directory. If
  607.         the ROL window is active, the file list displays all the ROL
  608.         files in the selected directory.
  609.  
  610.  
  611.     MUSICAL GIF                           CUSTOMIZING MUSICAL GIF    10
  612.  
  613.  
  614.     CUSTOMIZING MUSICAL GIF
  615.     ___________________________________________________________________
  616.  
  617.         The Options menu contains commands that let you view and change
  618.         various settings in MusicalGIF. All the commands in this menu
  619.         lead to a dialog box. Your changes will be automatically saved
  620.         when you exit from MusicalGIF.
  621.  
  622.  
  623.     DIALOG BOX BASIC
  624.  
  625.         When you are making settings in dialog boxes, you work with
  626.         four types of onscreen controls, namely action buttons, check
  627.         boxes, radio buttons and input boxes. You can press the [Tab]
  628.         and [Shift Tab] keys to move forward or back from one control
  629.         to another. The active control is highlighted in a different
  630.         color.
  631.  
  632.     Action Buttons
  633.  
  634.         All the dialogs have at least two buttons: [OK] and [Cancel].
  635.         If you choose [OK], the choices in the dialog box are made; the
  636.         [Enter] key is the shortcut for the button. If you choose
  637.         [Cancel], nothing is changed; and the [Esc] key is always a
  638.         shortcut for the button.
  639.  
  640.     Check Boxes
  641.  
  642.         A check box is preceded by the symbols [ ]. When you select a
  643.         check box, an 'X' appears in it to show you the option is on.
  644.         An empty box indicates the option is off. To change the status
  645.         of a check box, click it or its text, or press [Tab] until the
  646.         check box is highlighted and then press [Spacebar].
  647.  
  648.     Radio Buttons
  649.  
  650.         The radio button is very similar to the check box except that
  651.         they present mutually exclusive choices and is preceded by the
  652.         symbols ( ). To choose a radio button, click it or its text, or
  653.         press [Tab] until the group is highlighted and then use the
  654.         arrow keys to choose a particular radio button.
  655.  
  656.     Input Boxes
  657.  
  658.         Input boxes let you type in text. Basic text-editing keys work
  659.         in the text box. For example, arrow keys move the cursor and
  660.         the [Ins] key toggles the insert/overwrite status.
  661.  
  662.  
  663.     SCREEN
  664.  
  665.         The Screen dialog allows you to change the screen settings.
  666.         When you first run MusicalGIF, it will detect the graphic modes
  667.         available on your VGA card and are supported by MusicalGIF's
  668.         display engine.
  669.  
  670.  
  671.     MUSICAL GIF                           CUSTOMIZING MUSICAL GIF    11
  672.  
  673.  
  674.          ╔═[■]════════ Screen ════════════╗
  675.          ║                                ║
  676.          ║ »Resolution                    ║
  677.          ║  »[X] 320x200  «   >[  OK  ]<  ║
  678.          ║   [ ] 360x480                  ║
  679.          ║   [X] 640x400                  ║
  680.          ║   [X] 640x480       [Detect]   ║
  681.          ║   [X] 800x600                  ║
  682.          ║   [ ] 1024x768                 ║
  683.          ║   [ ] 1280x1024     [Cancel]   ║
  684.          ║                                ║
  685.          ╚════════════════════════════════╝
  686.  
  687.     Resolution
  688.  
  689.         The Resolution check boxes let you specify the resolutions that
  690.         your VGA card supports. If you find that a graphic mode is not
  691.         available on your VGA card, you must turn it off; otherwise a
  692.         picture that fit that particular resolution will not be shown
  693.         correctly.
  694.  
  695.         When showing a picture, MusicalGIF finds a resolution that will
  696.         fully encompass the picture, or a resolution that is closest to
  697.         picture size.
  698.  
  699.         If you are not sure what graphic modes your VGA card support,
  700.         you can choose the [Detect] button. Then MusicalGIF will
  701.         perform a hardware detect and turn on the available
  702.         resolutions.
  703.  
  704.     PICTURE
  705.  
  706.         The Picture dialog box lets you specify how the picture files
  707.         are to be shown.
  708.  
  709.          ╔═[■]═════════════════ Picture ═════════════════════╗
  710.          ║                                                   ║
  711.          ║ »Show Options                                     ║
  712.          ║   ( ) Wait after each picture         >[  OK  ]<  ║
  713.          ║  »(*) Slide show                «                 ║
  714.          ║   ( ) Slide show, start randomly                  ║
  715.          ║                                        [Cancel]   ║
  716.          ║  Delay between pictures  _5____                   ║
  717.          ║                                                   ║
  718.          ║  Selection                                        ║
  719.          ║   [ ] Show all pictures at start up               ║
  720.          ║   [ ] Select all at start up                      ║
  721.          ║   [ ] Clear selection after show                  ║
  722.          ║                                                   ║
  723.          ║  Display Options                                  ║
  724.          ║   [X] Shrink picture to screen size               ║
  725.          ║   [ ] Expand picture to screen size               ║
  726.          ║   [ ] Anti-aliasing                               ║
  727.          ║                                                   ║
  728.          ╚═══════════════════════════════════════════════════╝
  729.  
  730.  
  731.     MUSICAL GIF                           CUSTOMIZING MUSICAL GIF    12
  732.  
  733.  
  734.     Show Options
  735.  
  736.         In the Show Options radio buttons, when [Wait after each
  737.         picture] is chosen, MusicalGIF will show the selected GIF files
  738.         one by one and waits for an [Enter] key between each picture.
  739.  
  740.         When [Slide Show] is chosen, the selected GIF files will be
  741.         shown continuously with a delay between each picture.
  742.  
  743.         When [Slide Show, start randomly] is chosen, the selected GIF
  744.         files will be shown continuously with a delay between each
  745.         picture. MusicalGIF will randomly pick one of the selected GIF
  746.         as the starting point. This option is useful when you have a
  747.         lot of GIF files and you do not want to always show the first
  748.         selected GIF file first.
  749.  
  750.     Delay between pictures
  751.  
  752.         When [Slide Show] or [Slide Show, start randomly] is chosen,
  753.         this option specifies how long, in seconds, MusicalGIF should
  754.         wait until it shows another picture.
  755.  
  756.     Selection
  757.  
  758.         In the Selection check boxes, when [Show all pictures at start
  759.         up] is selected, MusicalGIF will show all the pictures when it
  760.         starts. How MusicalGIF show the pictures depends on the Show
  761.         Options.
  762.  
  763.         When [Select all pictures at start up] is selected, MusicalGIF
  764.         will select all the pictures when it starts.
  765.  
  766.         When [Clear selection after show] is selected, MusicalGIF will
  767.         clear all the selection after it shows the pictures. It is
  768.         useful when you want to make new selection after showing the
  769.         pictures.
  770.  
  771.     Display Options
  772.  
  773.         In the Display Options check boxes, when [Shrink picture to
  774.         screen size] is selected, MusicalGIF will shrink the picture if
  775.         the picture is larger than the screen, so that you can view the
  776.         whole picture.
  777.  
  778.         In the Display Options check boxes, when [Expand picture to
  779.         screen size] is selected, MusicalGIF will expand the picture if
  780.         the picture is smaller than the screen.
  781.  
  782.         When [Anti-aliasing] is selected, MusicalGIF will adjust the
  783.         colors to preserve the overall appearance of the image when
  784.         showing a reduced image. Otherwise, MusicalGIF will show a
  785.         reduced image by skipping pixels. However, anti-aliasing may
  786.         slow down the display process.
  787.  
  788.  
  789.  
  790.     MUSICAL GIF                           CUSTOMIZING MUSICAL GIF    13
  791.  
  792.  
  793.     MUSIC
  794.  
  795.         The Music dialog box lets you specify how the music files are
  796.         to be played.
  797.  
  798.          ╔═[■]════════════════ Music ═════════════════════╗
  799.          ║                                                ║
  800.          ║ »Play Options                                  ║
  801.          ║   ( ) Wait after each song         >[  OK  ]<  ║
  802.          ║  »(*) Continue to next song   «                ║
  803.          ║   ( ) Continue, start randomly                 ║
  804.          ║                                     [Cancel]   ║
  805.          ║  Delay between songs  _1_____                  ║
  806.          ║                                                ║
  807.          ║  Selection                                     ║
  808.          ║   [ ] Play all songs at start up               ║
  809.          ║   [ ] Select all at start up                   ║
  810.          ║   [ ] Clear selection after play               ║
  811.          ║                                                ║
  812.          ╚════════════════════════════════════════════════╝
  813.  
  814.     Play Options
  815.  
  816.         In the Play Options radio buttons, when [Wait after each song]
  817.         is chosen, the selected ROL files will be played one by one and
  818.         wait for an [Enter] key between each song.
  819.  
  820.         When [Continue to next song] is chosen, the selected ROL files
  821.         will be played continuously with a delay between each song.
  822.  
  823.         When [Continue, start randomly] is chosen, the selected ROL
  824.         files will be played continuously with a delay between each
  825.         song. MusicalGIF will randomly pick one of the selected ROL as
  826.         the starting point. This option is useful when you have a lot
  827.         of ROL files and you do not want to always play the first
  828.         selected ROL file first.
  829.  
  830.     Delay between songs
  831.  
  832.         When [Continue to next song] or [Continue, start randomly] is
  833.         chosen, this option specifies how long, in seconds, MusicalGIF
  834.         should wait until it plays another song.
  835.  
  836.     Selection
  837.  
  838.         In the Selection check boxes, when [Play all songs at start up]
  839.         is selected, MusicalGIF will play all the songs when it starts.
  840.         How MusicalGIF play the songs depends on the Play Options.
  841.  
  842.         When [Select all songs at start up] is selected, MusicalGIF
  843.         will select all the songs when it starts.
  844.  
  845.         When [Clear selection after play] is selected, MusicalGIF will
  846.         clear all the selection after it plays the songs. It is useful
  847.         when you want to make new selection after playing the songs.
  848.  
  849.  
  850.     MUSICAL GIF                           CUSTOMIZING MUSICAL GIF    14
  851.  
  852.  
  853.     DIRECTORIES
  854.  
  855.         The Directories dialog box lets you tell MusicalGIF where to
  856.         find the files it needs.
  857.  
  858.          ╔═[■]═══════════════ Directories ═══════════════════╗
  859.          ║                                                   ║
  860.          ║ »GIF Startup Directory                            ║
  861.          ║   \GIF\_______________________________________    ║
  862.          ║                                                   ║
  863.          ║  ROL Startup Directory                            ║
  864.          ║   \MUSIC\_____________________________________    ║
  865.          ║                                                   ║
  866.          ║  Instrument Bank File                             ║
  867.          ║   \MUSIC\STANDARD.BNK_________________________    ║
  868.          ║                                                   ║
  869.          ║  PKUNZIP.EXE Path                                 ║
  870.          ║   PKUNZIP.EXE_________________________________    ║
  871.          ║                                                   ║
  872.          ║  ARJ.EXE Path                                     ║
  873.          ║   ARJ.EXE_____________________________________    ║
  874.          ║                                                   ║
  875.          ║                           >[  OK  ]<   [Cancel]   ║
  876.          ║                                                   ║
  877.          ╚═══════════════════════════════════════════════════╝
  878.  
  879.     GIF Startup Directory
  880.  
  881.         The GIF Startup Directory specifies the directory that Musical
  882.         Gif should load the GIF files into the GIF window. This
  883.         directory only takes effect if it is not overrided by a
  884.         command line parameter.
  885.  
  886.     ROL Startup Directory
  887.  
  888.         The ROL Startup Directory specifies the directory that Musical
  889.         Gif should load the ROL files into the ROL window. This
  890.         directory only takes effect if it is not overrided by a
  891.         command line parameter.
  892.  
  893.     Instrument Bank File
  894.  
  895.         The Instrument Bank File specifies the full path name of the
  896.         Adlib instrument bank file, normally STANDARD.BNK. When playing
  897.         a ROL music file, the music engine requires this file to be
  898.         present.
  899.  
  900.       * It is very important that the full path name is specified.
  901.         Otherwise, the ROL music file will not be played when you
  902.         change the directory.
  903.  
  904.     PKUNZIP.EXE Path
  905.  
  906.         The PKUNZIP.EXE Path should specify the full path name of the
  907.         PKUNZIP.EXE, unless it is already specified in a directory in
  908.         the PATH environment variable.
  909.  
  910.     MUSICAL GIF                           CUSTOMIZING MUSICAL GIF    15
  911.  
  912.  
  913.     ARJ.EXE Path
  914.  
  915.         The ARJ.EXE Path should specify the full path name of the
  916.         ARJ.EXE, unless it is already specified in a directory in the
  917.         PATH environment variable.
  918.  
  919.  
  920.     COLORS
  921.  
  922.         The Colors dialog box allows you to set your color preferences
  923.         for each component of the MusicalGIF desktop.
  924.  
  925.          ╔═[■]═════════════════════ Colors ══════════════════════════╗
  926.          ║                                                           ║
  927.          ║ »Group             Item                   Color           ║
  928.          ║  »Desktop      «^  >Background        <^   ( ) Normal     ║
  929.          ║   Menus         ■                      ▓   ( ) Highlight  ║
  930.          ║   Dialogs       ▒                      ▓   ( ) Underline  ║
  931.          ║                 ▒                      ▓   (*) Inverse    ║
  932.          ║                 ▒                      ▓                  ║
  933.          ║                 ▒                      ▓                  ║
  934.          ║                 ▒                      ▓                  ║
  935.          ║                 ▒                      ▓                  ║
  936.          ║                 ▒                      ▓                  ║
  937.          ║                 ▒                      ▓  Text Text Text  ║
  938.          ║                 v                      v  Text Text Text  ║
  939.          ║                                                           ║
  940.          ║                                   >[  OK  ]<   [Cancel]   ║
  941.          ║                                                           ║
  942.          ╚═══════════════════════════════════════════════════════════╝
  943.  
  944.         Simply select
  945.         any Group and any Item within that Group, and the available
  946.         Foreground and Background colors will appear in the respective
  947.         sections of the dialog box. A sample of the currently selected
  948.         scheme will appear in the Item Color box. To change the default
  949.         color for that item, select your preferences from the
  950.         Foreground and Background palettes.
  951.  
  952.  
  953.     MUSICAL GIF                                          EXAMPLES    16
  954.  
  955.  
  956.     EXAMPLES
  957.     ___________________________________________________________________
  958.  
  959.  
  960.     1. USING MUSICAL GIF AS A GIF VIEWER
  961.  
  962.         MusicalGIF can be used as a GIF viewer if you do not have any
  963.         ROL files. It is especially useful in slide show mode because
  964.         it will decodes the next picture while waiting for the delay to
  965.         expire.
  966.  
  967.         To display as a slide show, select the
  968.  
  969.             (*) Slide show
  970.  
  971.         option under the Options/Picture dialog.
  972.  
  973.  
  974.     2. USING MUSICAL GIF AS A ROL PLAYER
  975.  
  976.         MusicalGIF can be used as a ROL player as well because it
  977.         provides an easy-to-use interface. In addition, MusicalGIF can
  978.         randomly pick a ROL file as the starting point. This avoids
  979.         playing the first selected file over and over again. You can
  980.         select the
  981.  
  982.             (*) Continue, start randomly
  983.  
  984.         option under the Options/Music dialog.
  985.  
  986.  
  987.     3. PLAYING ROL INSIDE A ZIP OR ARJ
  988.  
  989.         To reduce the disk space consumption of the ROL files, you can
  990.         compress them into a ZIP file using PKZIP.EXE or into a ARJ
  991.         file using ARJ.EXE. MusicalGIF supports both format and it can
  992.         play the ROL files inside the compressed file. All you have to
  993.         do is to setup the
  994.  
  995.             PKUNZIP.EXE Path
  996.             ARJ.EXE Path
  997.  
  998.         file paths under the Options/Directories dialog.
  999.  
  1000.  
  1001.     4. SHOWING GIF AND PLAYING ROL AT THE SAME TIME
  1002.  
  1003.         The most unique feature in MusicalGIF is the ability to show
  1004.         GIF pictures and play ROL songs at the same time. You should
  1005.         first select the ROL files you want to play in the ROL window,
  1006.         then push the [Play] button. It will begin playing the songs.
  1007.  
  1008.         To show GIF pictures, first switch to the GIF window by
  1009.         pressing the [Shift Esc] key, then select the GIF files and
  1010.         push the [Show] button.
  1011.  
  1012.  
  1013.     MUSICAL GIF                                          EXAMPLES    17
  1014.  
  1015.  
  1016.     5. HAVING ROL SONGS AS BACKGROUND MUSIC
  1017.  
  1018.         If you want to have the ROL songs as background music whenever
  1019.         you run MusicalGIF, you should select the
  1020.  
  1021.             (*) Continue, start randomly
  1022.             [X] Play all songs at start up
  1023.  
  1024.         options under the Options/Music dialog. It tells MusicalGIF to
  1025.         play all the songs automatically at start up. In addition, you
  1026.         should setup the
  1027.  
  1028.             ROL Startup Directory
  1029.  
  1030.         under the Options/Directories dialog so that MusicalGIF can
  1031.         find the ROL files.
  1032.  
  1033.  
  1034.     6. DOING IT ALL AUTOMATICALLY
  1035.  
  1036.         When you are doing a presentation or just want to impress your
  1037.         friends, you may want to setup MusicalGIF so that it will show
  1038.         all the GIF pictures and play all the ROL songs when you run
  1039.         MusicalGIF. Here is the options you should select
  1040.  
  1041.         a)  (*) Slide show, start randomly
  1042.             [X] Show all pictures at start up
  1043.  
  1044.         under the Options/Picture dialog and
  1045.  
  1046.         b)  (*) Continue, start randomly
  1047.             [X] Play all songs at start up
  1048.  
  1049.         under the Options/Music dialog.
  1050.  
  1051.         c) In addition, you should setup the startup paths for the GIF
  1052.         and ROL files
  1053.  
  1054.             GIF Startup Directory
  1055.             ROL Startup Directory
  1056.  
  1057.         under the Options/Directories dialog.
  1058.  
  1059.         After that, all you have to do is to run MusicalGIF by typing
  1060.         MUSICGIF in the command line and MusicalGIF will do the rest.
  1061.  
  1062.